home *** CD-ROM | disk | FTP | other *** search
/ Amiga Plus 1995 #2 / Amiga Plus CD - 1995 - No. 2.iso / pd / mui / muiffr / readme < prev    next >
Text File  |  1995-04-11  |  8KB  |  223 lines
  1. Short: GUI for selecting files of Fidonet boxes
  2. Type: comm/fido
  3. Uploader: steppler@pool.informatik.rwth-aachen.de
  4. Author: steppler@pool.informatik.rwth-aachen.de
  5.  
  6. NAME
  7.  
  8.     MUI Fido File Request 1.2
  9.  
  10. DESCRIPTION
  11.  
  12.     MUI Fido File Request is a GUI for selecting files from a filelist,
  13.     which almost every Fidonet mailbox provides for download.
  14.  
  15.     The list of selected files is written to a .REQ-file in your
  16.     outbound directory.
  17.  
  18.     The next time you call up your Fido Boss these files are
  19.     automatically downloaded by your Fidonet communications software.
  20.  
  21. CHANGES
  22.  
  23.     1.0 Initial release (23.01.94)
  24.  
  25.     1.1 (17.02.94)
  26.  
  27.     - clipboard support
  28.     - 4D addressing is used for the request file
  29.     - multiple nodes
  30.     - download of the selected files
  31.     - XPK support
  32.     - appending of passwords to the selected filenames
  33.  
  34.     1.2 (16.04.94)
  35.  
  36.     - display of telephone charges, sum of sizes of all selected files
  37.       in bytes and expected duration of transmission
  38.       (suggested by Stefan Gybas)
  39.     - two new environment variables MUIFFR/Outbound and MUIFFR/Config
  40.       (suggested by Klaus Melchior)
  41.     - bug removed: Filenames and passwords containing spaces inside of a
  42.       .REQ file are not split in several parts any longer when loaded
  43.       (reported by Matthias Scheler)
  44.     - enforcer hit removed (WORD-READ), which appeared sometimes during
  45.       startup
  46.     - After a successful search the filelist listview gadget in automatically
  47.       made the active object of the main window.
  48.       (suggested by Stefan Gybas)
  49.     - .REQ files, if present, are loaded from now on everytime the user
  50.       selects a different alias.
  51.  
  52. HARD- AND SOFTWARE-REQUIREMENTS
  53.  
  54.     - Amiga OS 2.04
  55.     - WB 2.1 (if you want to make use of localization)
  56.     - Stefan Stuntz' Magic User Interface 2.0 or better
  57.     - Fidonet mailer, e. g. Maximilian Hantsch's and Martin Laubach's TrapDoor
  58.  
  59. INSTALLATION
  60.  
  61.     Installer script supplied.
  62.  
  63. DOCUMENTATION
  64.  
  65.     MUIFFR 1.2 is pretty much self-explanatory.
  66.  
  67.     ***ATTENTION***
  68.     The format of the configuration file has changed form 1.1 to 1.2.
  69.     Old 1.1 configuration files can *still* be read.
  70.     When installing 1.2 over an already installed version 1.1
  71.     your 1.1 configuration file is *not* overwritten by the Installer script.
  72.     You can keep on using your old 1.1 configuration. After the installation
  73.     you only have to adapt your configuration to 1.2, i.e. enter
  74.     transmission rate, telephone charges etc. in the empty gadgets of the
  75.     configuration window, and save it..
  76.  
  77.     Configuration window:
  78.  
  79.     - For every node you can define an alias, a node number,
  80.       a telephone number, a password, a filelist associated
  81.       with this alias and a font compatible with this filelist.
  82.       MUIFFR automatically recognizes, if this list has been
  83.       packed with an XPK-packer, and unpacks it, when nescessary.
  84.  
  85.       Since. 1.2 you can specify the transmission rate of the
  86.       connection to the respective mailbox, the charges per unit
  87.       in cents and the duration of a unit in seconds. MUIFFR
  88.       uses these data to automatically calculate telephone
  89.       charges and display them in the main window.
  90.  
  91.     - When you press the 'Download' button of the main window,
  92.       your Fido communications software, e. g. TrapDoor,
  93.       is invoked. If you did not specify a phone number
  94.       for the current node, the contents of the 'Via Node'
  95.       string gadget (otherwise 'Via Number') are used for
  96.       invoking your Fido software.
  97.  
  98.       Following format specifiers are recognized.
  99.  
  100.         %t  telephone number
  101.         %n  node number
  102.         %l  nodelist directory
  103.         %p  password
  104.  
  105.       Examples:
  106.  
  107.       The current node has a telephone number:
  108.  
  109.         TrapDoor Call %t Boss %n Password %p
  110.  
  111.       The current node does not have a telephone number. It is
  112.       extracted out of the nodelist by your Fido software.
  113.  
  114.         TrapDoor Call %n Password %p Nodelist %l
  115.  
  116.     - The outbound directory is the placed, where the .REQ-file is to
  117.       be stored to.
  118.  
  119.       Since 1.2 you can specify the outbound directory via the environment
  120.       variable MUIFFR/Outbound. The environment variable has a higher
  121.       priority than the contents of the outbound gadget.
  122.  
  123.       Example: 1> setenv MUIFFR/Outbound Mail:outbound
  124.                   copy env:MUIFFR envarc:MUIFFR
  125.  
  126.     - Since 1.2 you can specify the name of the configuration file via the
  127.       environment variable MUIFFR/Config. The environment variable has a higher
  128.       priority than the default value PROGDIR:muiffr.config.
  129.  
  130.       Example: 1> setenv MUIFFR/Config PROGDIR:muiffr.config
  131.                   copy env:MUIFFR envarc:MUIFFR
  132.  
  133.     - Termination: Is every line of the .REQ-file to be terminated with
  134.       a linefeed character (dec.: 10) or with an carriage return (dec.: 13)
  135.       and a linefeed?
  136.  
  137.     - Filename position: Which word of the selected line is to be extracted
  138.       as the filename?
  139.  
  140.     - Since 1.2 the filesize entry of a selected line is recognized, too.
  141.       Byte position: Position of the filesize entry within the selected line.
  142.  
  143.     Main window:
  144.     - Password: Select one or more files and then press this button.
  145.       The password is now appended to each of them. Do not mistake
  146.       this password, which gives you download access to certain files,
  147.       by your personal password, with the help of which you are allowed
  148.       to download at all.
  149.  
  150.     - Filenames can be im- or exported via the clipboard (RAmiga-C/V/X).
  151.  
  152.     - Insert: The contents of the string gadget beneath the 'selected
  153.       files' listview gadget is appended to the list of these files.
  154.  
  155.     - Delete: One or more filenames are deleted from the list.
  156.  
  157.     - Load: The .REQ-file is loaded, if it exists.
  158.  
  159.     - Save: The .REQ-file is saved to the outbound directory using
  160.       4D addressing. If no file has been selected, but a .REQ-file
  161.       already exists, then this file is deleted.
  162.  
  163. DOWNLOAD
  164.  
  165.     Any Aminet site, e.g.
  166.  
  167.     USA (MO)     ftp.wustl.edu           128.252.135.4   pub/aminet/
  168.     USA (CA)     ftp.cdrom.com           192.153.46.2    pub/aminet/
  169.     USA (TX)     ftp.etsu.edu            192.43.199.20   pub/aminet/
  170.     Scandinavia  ftp.luth.se             130.240.18.2    pub/aminet/
  171.     Germany      ftp.uni-kl.de           131.246.9.95    pub/aminet/
  172.     Germany      ftp.uni-erlangen.de     131.188.1.43    pub/aminet/
  173.     Germany      ftp.cs.tu-berlin.de     130.149.17.7    pub/aminet/
  174.     Germany      ftp.uni-paderborn.de    131.234.2.32    pub/aminet/
  175.     Germany      ftp.uni-oldenburg.de    134.106.40.9    pub/aminet/
  176.     Germany      ftp.coli.uni-sb.de      134.96.68.11    pub/aminet/
  177.     Switzerland  ftp.eunet.ch            146.228.10.16   pub/aminet/
  178.     Switzerland  litamiga.epfl.ch        128.178.151.32  pub/aminet/ (*)
  179.     UK           ftp.doc.ic.ac.uk        146.169.2.1     pub/aminet/
  180.       (*) closed 6:30am to 4pm weekdays
  181.  
  182. DIRECTORY
  183.  
  184.     comm/fido
  185.  
  186. FILE NAME
  187.  
  188.     MUIFFR12.lha
  189.  
  190. FURTHER SOURCES
  191.  
  192.     FIDO:
  193.         Mowgli 2:242/7     +49-(0)241-40 59 49
  194.                2:2452/107
  195.  
  196. DISTRIBUTABILITY
  197.  
  198.      Freely distributable, but copyrighted.
  199.  
  200. KNOWN BUGS
  201.  
  202.     - If you start MUIFFR from CLI or another program (e.g. Filer or DirOpus),
  203.       reassure yourself the stack is set to at least 10000 bytes. Otherwise
  204.       unpredictable errors might occur.
  205.  
  206. ACKNOWLEDGEMENTS
  207.  
  208.     Thanks to
  209.  
  210.     - Klaus Melchior for suggestions and beta-testing.
  211.     - Matthias Scheler for bug-reports and suggestions.
  212.     - Stefan Gybas for suggestions.
  213.  
  214. AUTHOR
  215.  
  216.     Martin Steppler
  217.  
  218.     Internet: steppler@pool.informatik.rwth-aachen.de
  219.               steppler@dfv.rwth-aachen.de
  220.     ADSP:     steppler@cookies.adsp.sub.org
  221.     Fido:     2:242/7.12 steppler@mowgli.fido.de
  222.     FidoLite: 2:2452/107.12
  223.